Changes information about a volume.

OSErr PBSetVInfoAsync (
    HParmBlkPtr paramBlock
);

paramBlock

A pointer to a basic HFS parameter block.

function result

A result code.

DISCUSSION

The relevant fields of the parameter block are:

• ioCompletion

  On input, a pointer to a completion function.

• ioResult

  On output, the result code of the function.

• ioNamePtr

  On input, a pointer to the volume’s name. You can specify a pointer to a new name for the volume here.

• ioVRefNum

  On input, a volume specification.

• ioVCrDate

  On input, the date and time of initialization.

• ioVLsMod

  On input, the date and time of last modification.

• ioVAtrb

  On input, the volume attributes. Only bit 15 of ioVAtrb can be changed; setting it locks the volume.

• ioVBkUp

  On input, the date and time of the last backup.

• ioVSeqNum

  Used internally.

• ioVFndrInfo

  Information used by the Finder

You cannot specify the volume by name; you must use either the volume reference number, the drive number, or a working directory reference number.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)